[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
VS_WriteLn()         Write a string to a text file with CR/LF

Description:

  VS_WriteLn() allows the programmer to replace several calls to
  FWRITE() and all the parameters it requires.

Syntax:     

  First Call:

  l_Success = VS_WriteLn( n_Handle )


  Subsequent Calls:

  l_Success = VS_WriteLn( c_String )

Pass:       

  First Call:

  n_Handle is a numeric value representing the DOS file handle
  returned by FCREATE() or FOPEN().

  Subsequent Calls:

  c_String is a character expression containing the information to
  write to the file associated with n_Handle.  VS_WriteLn() will
  automatically add a Carrige Return (CHR(13)) and a line feed (CHR(10))
  to the end of c_String.


Return:     

  l_Success is a logical value that will be set to .T. if VS_Write()
  was successful, otherwise .F.

Notes:      

  YOU MUST CALL VS_WRITELN() WITH A DOS HANDLE EACH TIME YOU OPEN A NEW
  FILE!!!

Example:    

  n_Handle = FCREATE( "Myfile.Txt" )
  VS_WriteLn(n_Handle)
  VS_WriteLn("Hello World!")
  FCLOSE(n_Handle)

Usage:      

  When the programmer uses FWRITE() he has to continually use the DOS
  file handle,  VS_Write() remembers the handle and frees the programmer
  from having to re-type the handle so many times in the program file.

See Also: VS_Write()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson